Block chat users

Blocking stops a chat user from joining the Live Chat waiting queue for a set time. Use it for users who are abusive or send spam. A blocked user can still talk to the AI Agent. Only the handoff to a helpdesk agent is blocked.

Druid blocks authenticated users and anonymous users differently.

Authenticated users Anonymous users
Where the block is stored The user's Live chat blacklist in the Druid Portal The current conversation ([[ConversationInfo]])
Who can block A helpdesk agent through a flow, or a Druid Portal user who manages users A helpdesk agent through a flow
Who can unblock A Druid Portal user who manages users A flow

Let agents block users

Add a blocking path to the Live chat agent disconnected flow, after the agent chooses a resolution.

  1. Open the live-chat-agent-disconnect flow.
  2. After the resolution step, add a branch for blocking, for example a choice that the agent selects.
  3. On that branch, add an Action step. In Post Actions, add the HelpdeskClient.IsBlockedForLiveChat internal action with these parameters:
    Copy
    {
      "BlockIntervalMinutes": 1440,
      "BlockReason": "Abusive language",
      "SaveToChatActivityData": true
    }
  4. Save the flow.
Parameter Description Default
BlockIntervalMinutes How long, in minutes, the user is blocked. 1440 (24 hours)
BlockReason Why the user is blocked. —
SaveToChatActivityData true saves the block details for authenticated users in [[ChatActivityData]]. false

Anonymous users are blocked only within the current conversation. Keep their blocking period short, or use the default.

When a blocked user asks for a helpdesk agent, ConnectToHelpdeskAgent returns false in @InternalActionResult. Druid also sets [[HelpdeskClient]].IsBlockedForLiveChat. Handle this in your flow, the same way you handle Working hours and automatic sign-out.

Block data

For authenticated users, when SaveToChatActivityData is true, Druid stores these fields in [[ChatActivityData]]. The same details appear on the user's Live chat blacklist tab.

Field Value
LiveChatBlockedUntil When the block ends: the block time plus BlockIntervalMinutes.
LiveChatBlockedReason The reason.
LiveChatBlockedAt When the agent blocked the user.
LiveChatBlockedByAgentName The email of the agent who blocked the user.

For anonymous users, Druid stores [[ConversationInfo]].LiveChatBlockedUntil: when the block ends in the current conversation.

Block or unblock an authenticated user in the Druid Portal

  1. Select Administration > Users. To see only blocked users, select Show only blocked chat users.
  2. Next to the user, select Actions > Edit.
  3. Select the Live chat blacklist tab. The tab shows Blocked until, Reason, Blocked by, and Blocked at.
  4. Do one of the following: - To block the user, enter a Reason, enter the number of minutes next to Block user (default 1440), and then select Block user. - To unblock the user, select Unblock user.
  5. Select Save.

Unblock an anonymous user from a flow

Anonymous users are blocked in the conversation context, so a flow can unblock them. For example, in a flow step's Set Variables, set [[ConversationInfo]].LiveChatBlockedUntil to null, or set [[ConversationInfo]].LiveChatBlockedUntil to GetDate. When the user reaches that step, the block ends.